Version 3.0 User's Guide
Simplifying Maintenance With Groups	Previous | Next Contents

There will be times when you want to use a NetCloak command and specify a series of possible criteria. For example, you may want to hide a portion of advanced HTML from early versions of Netscape, Explorer (and maybe even Mosaic) users. Or you may want to show a portion of a page only to those users that are in your internal IP domain, which spans several ranges.

To make these commands easier to use, NetCloak includes a "groups" feature, which allows you to create a group of parameters that can then be used by name within any NetCloak command. You can create and manage groups from within the NetCloak user interface, and then simply refer to the name of the group instead of each item individually in NetCloak commands on your pages. This makes on-going maintenance easier by allowing you to change the group without having to update your HTML pages. It also makes reusing lists easy anywhere on your Web site. Just define the group once and use it anywhere.

Editing groups is done on the "Groups" tab of the NetCloak Lists window or with the Groups page of the NetCloak Web admin interface.

Editing Groups with the CGI

To edit groups from the CGI, select the "Variables..." command of the "Configuration" menu and click the "Groups" tab.

Figure 15: The Groups tab of the NetCloak Lists window.

The example above has several groups already created, including one called "SuperUsers". To see the items in any group, simply click on it and the "Items" list will change to a list of the items in the selected group.

Removing a single item or an entire group is as simple as selecting the item or group and clicking the appropriate Remove button.

To create a new group, enter the name of the group into the text entry field underneath the groups list, then click the Add Group button. The currently selected group or item has no effect when adding a group.

To add items to a group, first click on the name of the group in the groups list to select it. Then enter the name of the item to add to the group in the text field beneath the items list and click the Add Item button.

Once you have created your groups, click the OK button and they will be saved to the NetCloak.groups file. Note that you can also edit this file manually with a text editor. Each line in the NetCloak.groups file represents one group.

Editing Groups with a Web Browser

You can also edit groups using the Groups page of the NetCloak Web admin interface. Enter the URL of the NetCloak Web admin page into your Web browser, then click the "Groups" link at the top of the page.

Figure 16: The Groups page of the NetCloak Web admin interface.

To remove a group and all of its items, click the radio button in the "Select" column next to the group's name, then click the "Remove" button.

To create a group, click the "New..." button. To edit an existing group, click the radio button next to the group's name, then click the "Edit..." button. In either case, you are presented with the "Edit Group" page.

Figure 17: The Edit Group page of the NetCloak Web admin interface.

To change the group name, type the new name into the "Group Name" field, then click "Save Changes".

To add a new item to the group, enter the new item into the "New value" field, then click the "Add Item" button.

To remove an item from the group, click the radio button in the "Select" column next to the item to be removed, then click the "Remove" button.

To edit an item, click the radio button next to the item, enter the new value for the item in the "New value" field, then click the "Edit Item" button.

Using Groups in NetCloak Commands

To use a group in any NetCloak command, refer to it by name within the command, preceded by an exclamation point ("!"). The exclamation point tells NetCloak to look for and use a group rather than try to use the group name as a parameter.

Let's look at the "SupportsTables" example shown in the sample dialog above. Here is the HTML syntax for showing a table to certain browsers, without using groups:

    <HIDE><SHOW_CLIENT Mozilla MSIE Mosaic>    <TABLE>    <TR><TD>...
    By creating the "SupportsTables" group, we simplify this to:
    <HIDE><SHOW_CLIENT !SupportsTables>    <TABLE>    <TR><TD>...

Not only does this simplify the HTML, but when a new browser comes out that supports tables, you simply add the browser to the group. No changes are needed to the HTML pages at all.

Copyright © 1996-1999 Maxum Development Corporation http://www.maxum.com/	Previous | Next Contents